home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / lrgbra.z / lrgbra
Encoding:
Text File  |  1998-10-20  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. llllRRRRGGGGBBBBrrrraaaa((((3333GGGG))))                                                          llllRRRRGGGGBBBBrrrraaaa((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      llllRRRRGGGGBBBBrrrraaaa - sets the range of RGB colors used for depth-cueing
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee llllRRRRGGGGBBBBrrrraaaa((((rrrrmmmmiiiinnnn,,,, ggggmmmmiiiinnnn,,,, bbbbmmmmiiiinnnn,,,, rrrrmmmmaaaaxxxx,,,, ggggmmmmaaaaxxxx,,,, bbbbmmmmaaaaxxxx,,,, zzzznnnneeeeaaaarrrr,,,, zzzzffffaaaarrrr))))
  13.      iiiinnnntttteeeeggggeeeerrrr****2222 rrrrmmmmiiiinnnn,,,, ggggmmmmiiiinnnn,,,, bbbbmmmmiiiinnnn,,,, rrrrmmmmaaaaxxxx,,,, ggggmmmmaaaaxxxx,,,, bbbbmmmmaaaaxxxx
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 zzzznnnneeeeaaaarrrr,,,, zzzzffffaaaarrrr
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _r_m_i_n   expects the minimum value to be stored in the red bitplanes.
  18.  
  19.      _g_m_i_n   expects the minimum value to be stored in the green bitplanes.
  20.  
  21.      _b_m_i_n   expects the minimum value to be stored in the blue bitplanes.
  22.  
  23.      _r_m_a_x   expects the maximum value to be stored in the red bitplanes.
  24.  
  25.      _g_m_a_x   expects the maximum value to be stored in the green bitplanes.
  26.  
  27.      _b_m_a_x   expects the maximum value to be stored in the blue bitplanes.
  28.  
  29.      _z_n_e_a_r  expects the nearer screen z, to which the maximum colors are
  30.             mapped.
  31.  
  32.      _z_f_a_r   expects the farther screen z, to which the minimum colors are
  33.             mapped.
  34.  
  35. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  36.      llllRRRRGGGGBBBBrrrraaaa sets the range of RGB colors used for depth-cueing in RGB mode.
  37.      The screen z range [_z_n_e_a_r, _z_f_a_r] is mapped linearly into the RGB color
  38.      range [ (_r_m_a_x,_g_m_a_x,_b_m_a_x), (_r_m_i_n,_g_m_i_n,_b_m_i_n) ].  Screen z values nearer
  39.      than _z_n_e_a_r are mapped to (_r_m_a_x,_g_m_a_x,_b_m_a_x); screen z values farther than
  40.      _z_f_a_r are mapped to (_r_m_i_n,_g_m_i_n,_b_m_i_n).
  41.  
  42.      The valid range for _z_n_e_a_r and _z_f_a_r depends on the state of the GLCZRA
  43.      compatibility mode (see ggggllllccccoooommmmpppp).  If it is 0, the valid range depends on
  44.      the graphics hardware.  When multisample is enabled, and multisample
  45.      buffers exist in the current framebuffer configuration in the current
  46.      drawmode, the minimum is the value returned by ggggeeeettttggggccccoooo((((GGGGCCCCMMMMZZZZMMMMIIII)))) and the
  47.      maximum is the value returned by ggggeeeettttggggccccoooo((((GGGGCCCCMMMMZZZZMMMMAAAA)))).  Otherwise, the minimum
  48.      is the value returned by ggggeeeettttggggccccoooo((((GGGGCCCCZZZZMMMMIIIINNNN)))) and the maximum is the value
  49.      returned by ggggeeeettttggggccccoooo((((GGGGCCCCZZZZMMMMAAAAXXXX)))).  If the state of the GLCZRA compatibility
  50.      mode is 1, the minimum is $0 and the maximum is $7FFFFF.  _Z_n_e_a_r and _z_f_a_r
  51.      should be chosen to be consistent with the _n_e_a_r and _f_a_r parameters passed
  52.      to llllsssseeeettttddddeeee.  If _n_e_a_r < _f_a_r, then _z_n_e_a_r should be less than _z_f_a_r.  If
  53.      _n_e_a_r > _f_a_r, then _z_n_e_a_r should be greater than _z_f_a_r.  In either case, the
  54.      range [_n_e_a_r, _f_a_r] should bound the range [_z_n_e_a_r, _z_f_a_r].
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      depthc, getgde, glcomp, lsetde
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. llllRRRRGGGGBBBBrrrraaaa((((3333GGGG))))                                                          llllRRRRGGGGBBBBrrrraaaa((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEE
  75.      When using this routine, you should always explicitly set the GLCZRA mode
  76.      of ggggllllccccoooommmmpppp because its default is different on different models.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.